home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u001.dms / u001.adf / A-Gene.doc < prev    next >
Text File  |  1990-01-26  |  10KB  |  222 lines
  1.  
  2.  
  3.                                      A-Gene
  4.                                      ------
  5.                      A Geneaology Data-Base for the Amiga.
  6.                      -------------------------------------
  7.                                        by
  8.                                   Mike Simpson
  9.                          
  10.  
  11. History:
  12.  
  13. The first version of A-Gene was based on the program, "Geneaology on
  14. Display" by Melvin O. Duke which he wrote for the IBM PC, this program was 
  15. converted to AmigaBasic by an unknown author from the original Microsoft 
  16. Basic but was otherwise unchanged when I was asked if it could be compiled
  17. in A.C.Basic.
  18.  
  19.    In its original form the program consisted of 19 chained programs, and 
  20. was very slow to use due to the frequent disk accesses. Compiling the 19 
  21. programs using the A.C.Basic compiler v1.2 was not successful as it does
  22. not appear to like chaining programs with different palette settings.
  23.  
  24.      I therefore decided to merge all 19 programs into a single
  25. entity at the same time removing duplicated code and making the program more
  26. suitable for Anglican or Roman Catholic use (it was originally intended for
  27. members of the Church of Latter Day Saints (Mormons) and had features which
  28. related to that Church only). Accordingly I changed the "Ordinances" file to
  29. the Baptisms file and reduced the program from its original 5900 lines of
  30. basic to something like 4500 lines (still a pretty long program for Basic).
  31. The original version of A-Gene was released by Megadisk some 8 months ago
  32. and has been very successful, over 50 copies were sold but numerous other
  33. copies are around as I also gave a copy to the Australian Amiga Users Group
  34. who posted it on their BBS and it was subsequently posted on other BBS
  35. around Australia.
  36.  
  37. Due to the large number of letters I have received, listing bugs as well as
  38. suggested improvements, I have now completely re-written large sections
  39. of the program and recompiled it in A.C.Basic 1.3. The program is much more
  40. stable, has added features and all known bugs have been removed (please
  41. advise if you find any!!!), except for a problem in the sort routine when
  42. printing alphabetic lists - this prints out with odd names out of
  43. alphabetic order (approx 5 or 6 names out of order in 600).
  44.  
  45. Because of the sort problems, and the slowness of sorting large index files
  46. in AmigaBasic, I have now purchased a copy of G.F.A.-Basic and I am
  47. rewriting the whole program in this new language. This program can sort
  48. 1000 names in half a second compared with minutes on the existing program.
  49. It also allows easy access to mouse commands/menues/requesters etc, so it
  50. is intended to make the new version much more friendly to regular Amiga
  51. users. The present version is a copy of a IBM program, and looks it!!
  52. Rewriting in GFA is quite difficult, the two basics are not really
  53. compatible, so will take a while, but the new version should be out in
  54. approx April 1990 providing nothing happens to hold me up - All previous
  55. subscribers will be advised when the new program is released. (Note: It is
  56. hoped that the final version will allow both Anglican and Morman users to
  57. use the same program, as GFA basic is much more compact, therefore the
  58. program does not take up so much memory).
  59.  
  60. Environment:
  61. A-Gene as it is now will run on an Amiga with 1meg of RAM minimum, and really
  62. needs a printer (80 or 132 columns) to be of any use. It may be run from the
  63. CLI but you must set the stack to 125000 as a minimum, otherwise it will not
  64. run. From the CLI 1> prompt enter 1> STACK 125000 and it will load OK, it
  65. will also run from the workbench in the normal fashion by double-clicking on
  66. the A-Gene icon. Even with 1meg of memory, this program sometimes will not
  67. load if there are other programs resident in memory (FACII etc), so it is
  68. best to load it on its own after booting the Amiga.
  69.  
  70. This new version of A-Gene comes on a bootable disk, and is particularly
  71. easy to use on a 2-drive system, just boot your Amiga with the program disk
  72. in drive df0: and put your data disk in df1:. You will be advised that the
  73. system is set up for 600 persons/600 baptisms and 300 marriages, and that
  74. your data is on df1:. If you wish to change any of these parameters, you
  75. are given the option. e.g. if you only have one drive then it is better to
  76. give a disk name as your path where data is to be stored, e.g. answer the
  77. question with A-gene.data this will stop the program trying to store data
  78. on your bootable program disk. You can increase the number of
  79. persons/baptisms up to the maximum the disk will hold, approx. 2500. The
  80. number of marriages can also be increased, from experience, marriages will
  81. only be one quarter to one third of the number necessary for the persons
  82. file. It is recommended you do not increase the size of the files until you
  83. need the extra room as the larger the files, the slower the program runs.
  84. Instructions for enlarging files follows.
  85.  
  86. Capabilities:
  87. A-Gene as delivered holds the details of up to 600 persons and 300
  88. marriages, extra details (Baptism/confirmation dates, occupation etc) for
  89. all of the persons in the persons-file are also allowed for.
  90.  
  91. Details:
  92. A-Gene consists of the main program, plus 3 random-access files containing
  93. details of the Persons, Marriages and Baptisms. Once run, there will also be
  94. a Parent/Child index file and a Marriages Index file on your disk. On this
  95. new version, a short file "A-Geneparams" is stored in the S directory of
  96. your boot disk. This file is automatically created when the program is
  97. first run and includes the number of persons/marriages for your files, and
  98. the path name for your data access. 
  99.  
  100. Instructions for use:
  101. When first loaded, you will receive the title screen, and after pressing any
  102. key the program will check for the file s/a-geneparams. If this file is
  103. found it will display the start-up parameters as above. If it is not found,
  104. you will be asked how many persons/marriages to set up the system for
  105. initially and the name of your data access path.
  106.  
  107. Next you are passed to the main menu screen (Note: there are no intuition
  108. type menues nor mouse controls used in this program as it sticks with its
  109. original IBM PC interface). The menu items are as follows:-
  110.  
  111. 1. CREATPER
  112. This item creates a new persons file to hold the details of the number of
  113. people you have indicated on startup, e.g. If you wish to create a new
  114. database for a new family, you should format a blank disk, and place it in
  115. df1: (assuming this is the drive for your data access), select the number
  116. of persons/marriages as above, then select this menu item. You should then
  117. enter 1 as the starting record, and blank records from 1 thru to say 600 if
  118. this is the number selected on start-up will be written.
  119.  
  120. This menu item is also selected if you wish to expand a file, say your file
  121. is already 600 persons long, then you would enter say 850 persons on
  122. startup when asked how many persons you required and when selecting this
  123. menu item 1, you would enter 601 as the first blank record, and blank
  124. records 601 thru 850 would be created to expand your file.
  125.  
  126. 2. CREATMAR
  127. Creates a marriages file as in item 1 above.
  128.  
  129. 3. CREATORD
  130. Creates a baptisms (miscellaneous information) file as in item 1 above.
  131. Note the baptisms file must be the same size as the persons file to allow
  132. for extra data for each person.
  133.  
  134. 4. UPDATPER
  135. This is the main input screen for the program, selecting item 4 brings up a
  136. screen on which you can type the persons name, sex, birth/date/burial
  137. information, along with the record number of their father and mother. If
  138. their father/mother are not already in the data-base, just leave the numbers
  139. blank, they can be entered later once you have the necessary information.
  140. The instructions for each entry are selfexplanatory, when you have finished
  141. entering data just type "/" at any prompt, and you will be asked if you wish
  142. to save or forget the data.
  143.  
  144. 5. UPDATMAR
  145. Allows you to update the marriages file, (Note: Persons in the marriages file
  146. must already appear in the Persons file).
  147.  
  148. 6. UPDATORD
  149. Updates the baptisms file and allows you to enter further details about a
  150. person, i.e. baptism/confirmation dates, occupation, spouse etc.
  151.  
  152. 7. INDEXPC
  153. Creates an index file linking all the Parents/Children in the persons file.
  154.  
  155. 8. INDEXMAR
  156. Creates an index file of all linking all marriages to the persons in the
  157. persons file.
  158.  
  159. NOTE: Items 7 & 8 must be run after each session in which you have added
  160. information to the Persons and Marriages files so that the index is up to
  161. date at all times.
  162.  
  163. 9. PRINTPER
  164. This item prints out information about a person (or all persons) in the
  165. Persons file.
  166.  
  167. 10. PRINTMAR
  168. Prints information regarding a marriage (or all marriages) in the Marriages
  169. file.
  170.  
  171. 11. LISTPER
  172. Prints a list of all the persons in the persons file (Useful for when you
  173. have a large file, and you need to know the record number of say a persons
  174. father or mother who you had entered in an earlier session.
  175.  
  176. 12. LISTMAR
  177. Prints a list of all the marriages in the marriages file.
  178.  
  179. 13. LISTPCI
  180. Prints a list of the records in the Parents/Child index.
  181.  
  182. 14. ALPHAPER
  183. Prints an alphabetical List of Persons
  184.  
  185. 15. ALPHAMAR
  186. Prints an alphabetical List of Marriages
  187.  
  188. 16. DISPLAY
  189. Displays genealogical information on the screen in various formats
  190. including a family tree.
  191.  
  192. 17. PEDIGREE
  193. Prints Pedigree charts (Family Trees) for anyone in the Persons file. The
  194. program automatically sizes the chart in accordance with paper size being
  195. used.
  196.  
  197. 18. FAMILY
  198. Prints Family group sheets giving information on various members of the
  199. family.
  200.  
  201. 19. DESCEND
  202. Displays on the screen or prints Descendents Charts - Early versions of the
  203. program allowed for 4 generations only, however this new version allows you
  204. to display up to 10 generations either on screen or on paper.
  205.  
  206. The program is very comprehensive, easy to use and large enough for most
  207. families. I would recommend that a copy be made of this disk for safetys 
  208. sake. The program disk can now bear any name, and I normally name the data
  209. disk A-Gene.data, however there is no restriction on this, and if you are
  210. writing family trees for several families, it might be better to name them
  211. Smith.data, Jones.data etc etc.
  212.  
  213. I hope this program will enable you to carry out interesting research into
  214. your own family background.
  215.  
  216. Mike Simpson
  217. 11 Merauke St.
  218. Whalan, N.S.W. 2770
  219. Australia.
  220. Phone (02)-6254096
  221. Fax   (02)-2290697
  222.